Summary

Implements the bounty request from #1540:

1. New deeplink actions for controlling recording:

   • pause_recording - Pause current recording
   • resume_recording - Resume paused recording
   • toggle_pause_recording - Toggle pause state
   • set_camera - Switch camera input
   • set_microphone - Switch microphone input

2. Raycast extension in extensions/raycast/:

   • Start/Stop/Pause/Resume recording commands
   • Toggle pause functionality
   • Uses cap-desktop:// deeplink protocol
   • No-view commands for quick keyboard-driven control

Deeplink Examples

cap-desktop://action?value={"pause_recording":null}
cap-desktop://action?value={"toggle_pause_recording":null}
cap-desktop://action?value={"set_camera":{"device_id":"FaceTime HD Camera"}}
cap-desktop://action?value={"set_microphone":{"label":"MacBook Pro Microphone"}}

Testing

The Rust code leverages existing pause_recording, resume_recording, and toggle_pause_recording functions from recording.rs. The Raycast extension uses the standard Raycast API open() function to trigger deeplinks.

Note: I developed this on Linux and couldn't test on macOS. Would appreciate testing from maintainers.

Closes #1540

Greptile Overview

Greptile Summary

This PR implements bounty #1540 by adding enhanced deeplink actions for controlling Cap recordings and a new Raycast extension for keyboard-driven control. The implementation adds five new deeplink actions (pause_recording, resume_recording, toggle_pause_recording, set_camera, set_microphone) to the Rust backend and creates a complete Raycast extension with corresponding commands.

Key Changes:

• Extended DeepLinkAction enum with 5 new variants that integrate with existing recording module functions
• Created Raycast extension in extensions/raycast/ with 5 commands (start, stop, pause, resume, toggle)
• Each Raycast command uses the cap-desktop:// protocol to trigger deeplink actions
• Proper error handling in TypeScript with user-facing HUD notifications

Issues Found:

• Missing icon file (cap-icon.png) referenced in package.json
• Hardcoded display name "Built-in Display" in start-recording command will fail on systems without this exact display name
• Code comments added which violate the repository's no-comments policy

Architecture:
The integration follows the existing deeplink pattern cleanly. The Rust code leverages existing functions from recording.rs and lib.rs, ensuring consistency with the desktop app's state management. The Raycast extension provides a lightweight keyboard-driven interface without requiring UI views.

Confidence Score: 3.5/5

• Safe to merge after addressing the missing icon file and hardcoded display name
• The implementation is architecturally sound and properly integrates with existing code. However, two critical issues prevent immediate merge: the missing icon file will cause the Raycast extension to fail validation, and the hardcoded "Built-in Display" will cause runtime failures on many systems. The code comments are style violations that should be fixed but won't break functionality.
• Pay close attention to extensions/raycast/package.json (missing icon) and extensions/raycast/src/start-recording.tsx (hardcoded display name)

Important Files Changed

Sequence Diagram

sequenceDiagram
    participant User
    participant Raycast
    participant DeeplinkHandler as Cap Deeplink Handler
    participant DeeplinkAction as DeepLinkAction::execute
    participant Recording as recording.rs
    participant AppState as App State

    User->>Raycast: Trigger command (e.g., pause-recording)
    Raycast->>Raycast: Build deeplink URL
    Note over Raycast: cap-desktop://action?value={"pause_recording":null}
    Raycast->>DeeplinkHandler: open(deeplink)
    
    DeeplinkHandler->>DeeplinkHandler: Parse URL & extract action
    DeeplinkHandler->>DeeplinkAction: execute(app_handle)
    
    alt PauseRecording
        DeeplinkAction->>Recording: pause_recording(app, state)
        Recording->>AppState: Acquire state lock
        Recording->>AppState: Pause current recording
        Recording-->>DeeplinkAction: Ok(())
    else ResumeRecording
        DeeplinkAction->>Recording: resume_recording(app, state)
        Recording->>AppState: Acquire state lock
        Recording->>AppState: Resume current recording
        Recording-->>DeeplinkAction: Ok(())
    else TogglePauseRecording
        DeeplinkAction->>Recording: toggle_pause_recording(app, state)
        Recording->>AppState: Check current state & toggle
        Recording-->>DeeplinkAction: Ok(())
    else SetCamera
        DeeplinkAction->>AppState: set_camera_input(app, state, device_id)
        AppState->>AppState: Update camera feed
        AppState-->>DeeplinkAction: Ok(())
    else SetMicrophone
        DeeplinkAction->>AppState: set_mic_input(state, label)
        AppState->>AppState: Update mic feed
        AppState-->>DeeplinkAction: Ok(())
    end
    
    DeeplinkAction-->>DeeplinkHandler: Result
    DeeplinkHandler-->>Raycast: Success/Error
    Raycast->>User: Show HUD notification

Context used:

• Context from dashboard - CLAUDE.md (source)